Skip to main content
POST
Submit feedback about one memory [Cloud-only]

Authorizations

Authorization
string
header
required

API key issued by EverOS, sent as Authorization: Bearer <api_key>.

Body

application/json

Rate one memory record [Cloud-only].

The target is addressed the way the read APIs return it: memory_type + memory_id, plus item_id for a profile, whose rateable unit is one item inside profile_data rather than the whole document. Everything identifying (tenant, submitter) is derived on the server; the whitelist is closed.

A reason is DESCRIPTIVE. No code triggers a mutation by itself — privacy in particular is a signal, not a deletion request.

memory_type
enum<string>
required

Kind of the target memory, as named by memory.get / search.

Available options:
episode,
profile,
agent_case,
agent_skill
memory_id
string
required

The target's id from memory.get / search (the profile document's id for profile).

Required string length: 24
Pattern: ^[0-9a-fA-F]{24}$
rating
enum<string>
required

Direction of the explicit assessment.

Available options:
positive,
negative
item_id
string | null

Which profile item is rated (profile_data.*[].item_id). Required for profile, not accepted for other kinds.

Pattern: ^(ei|it)_[0-9a-f]{24}$
reason
enum<string> | null

Structured reason used for analysis; it never triggers mutation. Negative ratings only. No default: an unset reason means the caller was not asked, other means they rejected the list — collapsing the two would corrupt every breakdown. Same base list as Reason.code on /api/v2/memory/update and /delete_by_ids minus missing, which a rating cannot express because it always names a memory that exists. (outdated — "right when written, wrong now" — reaches Reason.code with the engine's next release; on release-20260901_v15 it is feedback-only.)

Available options:
hallucination,
outdated,
wrong_subject,
wrong_time,
redundant,
privacy,
style,
other
note
string | null

Optional free-text explanation of the rating.

Required string length: 1 - 256
suggestion
string | null

What the memory should have said, as free text. Negative ratings only. Stored with the signal and never applied automatically.

Required string length: 1 - 8000

Response

Successful Response

request_id
string
required

Request trace id (peer to data)

data
FeedbackData · object
required

Endpoint-defined business result